home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 2 / Atari Mega Archive CD - Volume 2.iso / 8bit / cislib_a / macwdg.doc < prev    next >
Text File  |  1995-04-22  |  7KB  |  284 lines
  1.  
  2.  MACWDG IS A MACHINE LANGUAGE UTILITY
  3. DESIGNED FOR USE WITH THE MAC/65
  4. ASSEMBLER FROM OSS. IT IS FUNCTIONALLY
  5. EQUIVALENT TO MY EARLIER BASWDG
  6. PROGRAM, PROVIDING ACCESS TO SIMPLE
  7. DOS FUNCTIONS WITHOUT EXIT TO
  8. DUP.SYS.
  9.  
  10.  
  11.  If you already have BASWDG, you don't
  12. need this whole DOC file..the
  13. functions are pretty much the same.
  14. However READ THE NEXT 4 PARAGRAPHS!!!
  15.  
  16.  
  17.  THERE IS A 'DOCUMENTED FEATURE' (I.E.
  18. WEIRD BUG)
  19.  
  20.  
  21.  DO NOT PRESS <RESET> WHILE YOU ARE IN
  22. THE MACWDG MENU.
  23.  
  24.  IF, FOR SOME REASON YOU DO, YOUR
  25. COMPUTER WILL GET HINKY. FORTUNATELY,
  26. IT WON'T CRASH IMMEDIATELY. SAVE ANY
  27. WORK YOU NEED, AND THEN DO A COMPLETE
  28. COLD-START. IF YOU DON'T, MAC <WILL>
  29. COLD-START <ITSELF> ON THE NEXT
  30. RESET!! AAARGH!!!!
  31.  
  32.  I'VE BEEN TRYING TO TRACK THIS DOWN
  33. FOR A YEAR, WITH NO LUCK. BUT I
  34. HONESTLY THINK THAT THE PROGRAM IS
  35. USEFUL ENOUGH THAT, AS LONG AS YOU
  36. DON'T DO THAT <BAD THING> ...
  37.  
  38.  
  39.             WHAT IT DOES
  40.  
  41.  Once MACWDG is installed, it takes
  42. over the computer's DOS vector. When
  43. you issue a DOS command, instead of
  44. loading DUP.SYS, you'll run MACWDG. It
  45. presents a Quick Menu for the most
  46. commonly used disk functions without
  47. disturbing your code in EDIT or TEXT
  48. (so you can save those 45 sectors for
  49. MEM.SAV on D8.) Trust me. This is a
  50. lot faster, and less hassle than
  51. constantly going to DUP.
  52.  
  53.  This is an Old Idea. I've tailored
  54. MACWDG to match my own programming
  55. needs and quirks. You can do the same
  56. thing. See MACWDG.M65 for Source
  57. Code.
  58.  
  59.  
  60.                NUMBERS
  61.  
  62.  Check the title screen for Critical
  63. Values.
  64.  
  65.  The RESET defaults are MACWDG
  66. shadows. You can change them with a D
  67. command in DDT. TEXT and BACK set
  68. MAC's internal color registers (info
  69. from the ubiquitous Bill Wilkinson).
  70. Poke them as you would 709 and 710 in
  71. Basic. The keyboard is speeded up.
  72. These shadow 729,730.
  73.  
  74.  
  75.  
  76.      ABSOLUTELY RESERVED MEMORY
  77.  
  78.  Starting at $1CFC, this block is
  79. QUITE SMALL. It should NEVER, EVER, be
  80. overwritten.
  81.  
  82.  MACWDG lives mostly in 'SHADOW RAM',
  83. UNDER the OSS cartridge (another thank
  84. you to OSS for info!) When you call it
  85. by typing DOS, MAC is disabled, and
  86. MACWDG runs. Exit and MAC is back.
  87. What that means is that you have a 1K+
  88. program that steals less than a page
  89. from free memory. Handy, no?
  90.  
  91.  
  92.  
  93.  
  94.         MACWDG MENU FUNCTIONS
  95.  
  96.  
  97.               DIRECTORY
  98.  
  99.  Type the drive number. If RAMDISK.COM
  100. hasn't loaded, or if you're using DOS
  101. 2.0, only 1 or 2 are allowed.
  102. Otherwise you have D8: to play
  103. with...hoo-hah.
  104.  
  105.             DEFAULT DRIVE
  106.  
  107.  That's the drive that doesn't need a
  108. Device Spec (eg. D1:) when typing in
  109. file names. In DUP.SYS, the Default is
  110. always D1: In the MACWDG menu, things
  111. are more flexible.
  112.  
  113.  THE MACWDG DEFAULT DRIVE IS THE LAST
  114. DRIVE FROM WHICH YOU READ A
  115. DIRECTORY.
  116.  
  117.  The intent is to default to the drive
  118. whose files are currently listed on
  119. the screen. This can be confusing
  120. until you get used to it. So there are
  121. a couple of helps:
  122.  
  123.   D: is ALWAYS translated to D1:
  124.  
  125.   The FULL FILESPEC, as translated, is
  126. printed on the screen before any
  127. action is taken. LOOK AT IT! If it's
  128. not what you intended, you can bail
  129. out.
  130.  
  131.          CHANGED YOUR MIND?
  132.  
  133.  The All Purpose Quit Key is BREAK. At
  134. ANY prompt, pressing it will exit to
  135. the menu.
  136.  
  137.  BREAK disabled? There are a couple of
  138. alternatives:
  139.  
  140.  AT FILE NAME 'INPUT' PROMPTS: use a
  141. 'Null Input.' Press RETURN ONLY with
  142. no name.
  143.  
  144.  AT ANY OTHER PROMPT: hit ESCAPE.
  145.  
  146.                CONFIRM
  147.  
  148.  Before MACWDG acts, it will ask
  149. 'OK?', just to make sure that you
  150. really want to do what you said.
  151.  
  152.  1) Want to quit? Hit BREAK,ESCape, or
  153. N (for NO, of course.)
  154.  
  155.  2) Go ahead? Any other key.
  156.  
  157.             FILE COMMANDS
  158.  
  159.  These are E (Erase), R (Rename), and
  160. M (Move File) At the command prompts,
  161. INPUT the filename (remember, no
  162. device spec needed if you're using the
  163. DEFAULT.) Abort by pressing RETURN
  164. only, or BREAK.
  165.  
  166.  ERASE zaps the selected file. 
  167.  
  168.  RENAME works in the normal fashion.
  169. Type the old name, a comma, and the
  170. new name. Sorry, you STILL have to
  171. watch out for duplicate names (don't
  172. blame me..I'm just using XIO 32!) Use
  173. RENAME with the target directory on
  174. the screen to make sure you're not
  175. doing something nasty. Make sure you
  176. complete INPUT, providing the comma
  177. and new name. Otherwise, you're liable
  178. to find your file renamed to SECTORS
  179. (what?)
  180.  
  181.               MOVE IT!
  182.  
  183.  This is my favorite. The MOVE command
  184. combines the functions of COPY FILE
  185. (C) and DUPLICATE FILE (O) in the
  186. DUP.SYS menu. It's especially useful
  187. with D8.
  188.  MOVE uses 'Free RAM', starting at the
  189. top of your program, for its buffer
  190. (do you have data up there? Careful.)
  191. The smaller your program the bigger
  192. the buffer. (Error 2 means your RAM is
  193. full!)
  194.  
  195.             MOVE COMMANDS
  196.  
  197.  There are SEPARATE PROMPTS for FROM
  198. and TO filenames. Remember to use the
  199. Default to cut down on typing.
  200.  
  201.  Any legal device (E:, P:, C:, D:) can
  202. be used. Please remember the colon!
  203.  
  204.        THE LEYENBERGER OPTION
  205.  
  206.  If you want to use the SAME FILE NAME
  207. for a disk MOVE, you can type ONLY the
  208. Device Spec (INCLUDING THE COLON!) at
  209. the TO prompt. The FROM file name will
  210. be appended.
  211.  
  212.          COPY or DUPLICATE?
  213.  
  214.  COPY FILE (no swaps) is automatically
  215. assumed with files that don't go TO
  216. disk. Handy for dumping text files to
  217. P: or screen (E:) Likewise if you use
  218. 2 different drives (like MOVEing a
  219. file to D8 from D1)
  220.  
  221.  If the SAME D:num is used for FROM
  222. and TO, MACWDG invokes DUPLICATE FILE,
  223. and prompts for swaps.
  224.  
  225.  These work like 'OK?'  BREAK/ESC/N to
  226. exit, or RETURN to continue. Depending
  227. on exactly where you are in the
  228. process, an exit may leave you with a
  229. partial file on the TO disk. Erase as
  230. necessary. For severe problems,
  231. (inserted the wrong disk?) use
  232. DISKFIX.COM.
  233.  
  234.            EXITING MACWDG
  235.  
  236.  Cart returns you to EDIT or TEXT.
  237.  
  238.  To go all the way and exit to
  239. DUP.SYS, type @ (SHIFT-8.) That's
  240. intentionally a two-finger combo, to
  241. avoid accidents.
  242.  
  243.               DUP.SYS??
  244.  
  245.  I try to avoid DUP.SYS, but sometimes
  246. it's necessary (DISKFIX!)
  247.  
  248.  IF MEM.SAV IS ACTIVE WHEN YOU EXIT
  249. DUP.SYS WITH THE B COMMAND, MACWDG is
  250. still there. However, it has been
  251. unhooked (safety first) To rehook it,
  252. go to DDT,*$0C, then DFC1C to
  253. reinstall the DOSINI hook.
  254.  
  255.  
  256.  
  257.  
  258.  Exit DDT, and RESET. MACWDG is back.
  259. Do this BEFORE any drastic action like
  260. a RESET, LOAD, or NEW.
  261.  DO make sure that MEM.SAV has
  262. restored the RAM. LIST if you're not
  263. sure. Remember that using options C
  264. and O in DUP can zap MEM.SAV (That's
  265. why I wrote MOVE)
  266.  
  267.  IF MEM.SAV IS NOT ACTIVE, you can
  268. usually Reload MACWDG with the L
  269. command. If in doubt, Reboot.
  270.  
  271.  Running DUP.SYS on D8 with no
  272. MEM.SAV, alters the sector count for
  273. that file(??) Beats me. Even if it
  274. says DUP.SYS is taking up 156 sectors,
  275. it's really only using 42, as
  276. confirmed by FREE SECTORS. So far,
  277. this seems harmless.
  278.  
  279.  
  280.  have fun....
  281.  
  282. >>don
  283.                                       
  284. qqqqqqqqqqqqqqq